home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / tscnv104.zip / TSCONV.DOC < prev    next >
Text File  |  1991-08-15  |  8KB  |  196 lines
  1.  
  2.  
  3.  
  4.     TSCONV; TosScan Converter 1.04                     14 Aug 1991
  5.     ------------------------------
  6.  
  7.         Copyright 1990, 1991 Mats Wallin    All rights reserved
  8.         2:201/329@fidonet, 9:462/110@virnet
  9.  
  10.  
  11.         TSCONV is the follow-up program to TS2FD, the program which
  12.         converted TosScan's areadefinitions to FrontDoor's format.
  13.         TSCONV will convert TosScan's areadefinitions to FrontDoor's,
  14.         and/or RemoteAccess' and/or up to 10 textfiles (an AREAS.BBS
  15.         file, or any other textfile).
  16.  
  17.         You're not required to have FrontDoor or RemoteAccess, YOU
  18.         decide what you want TSCONV to create. It could be everything
  19.         it can do (FD, RA + 10 textfiles), or only 1 textfile (or
  20.         even nothing at all, but in that case, I don't think you
  21.         need TSCONV). TSCONV doesn't force you to do something
  22.         you don't want to do.
  23.  
  24.         You're required to have TosScan, and TosScan also requires
  25.         FD.SYS, so I guess that you probably also have FD.
  26.  
  27.         In the rest of this document, I've supposed that you want
  28.         TSCONV to create everything, so I'm always talking about
  29.         both FrontDoor and RemoteAccess, but this isn't a
  30.         requirement.
  31.  
  32.  
  33.     Why TSCONV?
  34.  
  35.         The reason behind TSCONV, is that you shouldn't have to add
  36.         a new area in all the places you currently have to, TosScan's
  37.         TSETUP, FrontDoor's SETUP, RemoteAccess' RACONFIG, and some
  38.         textfiles you maintain with the same info. Instead, you maintain
  39.         all your areadefinitions with TSETUP, and then run TSCONV,
  40.         which fully automatic updates the other definitions
  41.  
  42.         A new feature, is that you can maintain all FD's different
  43.         folder statuses with TSCONV. You can give all areas some
  44.         default status, change some status because of which group an 
  45.         area belongs to, and for another area, specify all status exactly.
  46.  
  47.         When TSCONV updates RA's area definitions, then you can
  48.         easily specify different security levels and flags as
  49.         default, for a group of areas, or a specified area.  It's
  50.         also possible to specify what kind of area it is (public,
  51.         private, both, read-only), and change all of the other area
  52.         options.
  53.  
  54.         And, as already mentioned, TSCONV can also create textfiles
  55.         with all the areadefinitions. This file could look like
  56.         an AREAS.BBS file, or any other format choosen. The only
  57.         restriction is that each area is written on a single line.
  58.  
  59.  
  60.     Area levels - default, group, area
  61.  
  62.         When specifying different statuses, security etc for an area,
  63.         it's possible to do that at three different levels. First of
  64.         all, it's possible to specify default status, security etc,
  65.         for all areas not mentioned later. The second level is to 
  66.         specify these things for a whole group of areas. (Groups are 
  67.         the groups (A-Z) defined with TSETUP). The third level makes 
  68.         it possible to specify certain status or securities for a 
  69.         certain area.
  70.  
  71.  
  72.     Configuration file
  73.  
  74.         TSCONV requires a configuration file, which exactly specifies
  75.         what should be done, which statuses, securities, flags etc
  76.         that should be used, which areas that should be included,
  77.         which files should be created, etc. The default filename of
  78.         this file is be TSCONV.CFG. TSCONV will search for this
  79.         file in the current directory, and in FrontDoor's system-
  80.         directory. It is also possible to specify the filename
  81.         as a parameter to TSCONV, e.g. 'TSCONV CONFIG.CFG'.
  82.  
  83.         A file called EXAMPLE.CFG is included together with this 
  84.         doc-file. That file explains all commands and other
  85.         things that are possible to use in the TSCONV.CFG file. It is
  86.         not recommended to use EXAMPLE.CFG without modifying it to
  87.         suit your needs. I recommend copying it to TSCONV.CFG, and
  88.         then start to read and edit TSCONV.CFG, before trying to
  89.         run TSCONV.
  90.  
  91.  
  92.     How to run TSCONV
  93.  
  94.         There are, as I see it, three ways of running TSCONV. The first
  95.         is to run it manually each time you've done something in
  96.         TSETUP. If you remember to do it, everything will be correct,
  97.         everywhere, all the time, but if you forgot to run TSCONV ...
  98.         The second way is to run it in your nightly maintaince. This
  99.         is no problem, since TSCONV doesn't need any input. The third
  100.         (and best) way, is to combine 1 and 2 :-)
  101.  
  102.         TSCONV will by default write information to TosScan's logfile
  103.         when it adds or removes an area, which will make it easier to
  104.         run TSCONV unattended. This can of course be disabled.
  105.  
  106.         Anyway, each time you run TSCONV, it will check that the areas
  107.         defined in TSETUP exists in FrontDoor and RemoteAccess. If
  108.         an area is missing, TSCONV will add it. TSCONV also checks that 
  109.         each area in FrontDoor/RemoteAccess is defined in TSETUP, if 
  110.         it isn't, the area is removed.
  111.  
  112.         TSCONV will NOT remove the area defined as the dupe directory,
  113.         and (if you're using the (q) flavor of TosScan) the 
  114.         RemoteAccess netmail board.
  115.  
  116.         If TSCONV discovers that you have two areas with the same 
  117.         boardnumber, it will display a warning message. The netmail
  118.         board defined in TSETUP is not included in this check, since
  119.         some users have the netmail board defined in the Area Manager,
  120.         to be able to use TSUTIL to maintain that board.
  121.  
  122.  
  123.     Important notes
  124.  
  125.         If you have local areas defined in RemoteAccess, you must
  126.         tell TSCONV about them. The easiest (and best in my opinion)
  127.         is to define the local areas in TSETUP (without any nodes in
  128.         the exportlist), which will make it possible for TSUTIL to 
  129.         maintain these areas. The other way you can do it, is to use
  130.         the KEEP verb, which informs TSCONV that it should keep 
  131.         specified boardnumbers/paths. If you don't do one of these
  132.         things, all your local areas, that are defined in RA, will be
  133.         removed.
  134.  
  135.         I also would like to mention, that if you let TSCONV sort 
  136.         your folders in FD's setup, the folder number will of course
  137.         change. If you are used with a special folder number for an 
  138.         area, don't use the sort option.
  139.  
  140.  
  141.     Screen I/O
  142.  
  143.         By default, TSCONV will do all it's screen I/O via BIOS
  144.         calls. If you of any reason (for example running TSCONV remote)
  145.         don't like this, it's possible to force TSCONV to use DOS
  146.         calls instead, or, if prefered, interrupt 29h. To force
  147.         TSCONV to do this, use one of the following lines:
  148.  
  149.         SET VIDEO=DOS
  150.         SET VIDEO=INT29
  151.         SET VIDEO=BIOS
  152.  
  153.         before you start TSCONV. With the first example, it's possible
  154.         to redirect the output to a file or to a comport if you're
  155.         running TSCONV remote. With the second example, the output
  156.         will be somewhat faster if you have a super fast ansi driver
  157.         loaded. The third example is what TSCONV uses by default.
  158.  
  159.  
  160.     Disclaimer etc               
  161.  
  162.         This program is provided as is, without warranty of any kind.
  163.         The only thing guaranteed is that TSCONV will occupy some 
  164.         diskspace.
  165.  
  166.         FrontDoor, TosScan and RemoteAccess are trademarks
  167.         of their respective holders.
  168.  
  169.  
  170.     Registering
  171.  
  172.         If you like TSCONV, and continue to use it after a first
  173.         trial period, you're required to register it. To register,
  174.         the only thing you have to do is to send a postcard with
  175.         your name, netmail address and which program you're 
  176.         registering to:
  177.  
  178.         Mats Wallin
  179.         Förskottsvägen 11
  180.         S-126 44 Hägersten
  181.         Sweden
  182.  
  183.         In return, you will receive messages with information about
  184.         new versions of this program.
  185.  
  186.         All comments, suggestions etc could be sent to me at:
  187.  
  188.         2:201/329@fidonet
  189.         9:462/110@virnet
  190.  
  191.  
  192.     Version history
  193.  
  194.         Read the file RELEASE.NOT for information about what have
  195.         changed since the previous version.
  196.